home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / AMICUS / AMICUS08.ADF / Progs / arc.doc < prev    next >
Text File  |  1986-04-02  |  6KB  |  163 lines
  1. AmigArc - Archive utility, Version 0.07, created on 03/09/86 at 18:46
  2.  
  3.  
  4. TEST VERSION -- Compatible with ARC v5.0
  5.  
  6.  
  7. (C) COPYRIGHT 1986 by Raymond S. Brand; ALL RIGHTS RESERVED
  8. (C) COPYRIGHT 1985,86 by System Enhancement Associates; ALL RIGHTS RESERVED
  9.  
  10.  
  11. Please refer all inquiries to:
  12.  
  13.        Raymond S. Brand
  14.        c/o The Lido Hotel (a Fido BBS)
  15.        (203) 248-7324
  16.  
  17.  
  18. Hello,
  19.  
  20.    AmigArc v0.07 is a version of ARC v5.0 ported to the Amiga. As such, it
  21. can perform all of the normal ARC commands on '.ARC' files (for information
  22. on ARC commands, find a copy of ARC.DOC).
  23.    This is a beta test version and extreme caution (have backups!) should
  24. be exercized when using it.
  25.  
  26. Bugs fixed (I hope!!) in version 0.07:
  27.  
  28.    1) '.ARC' files may now be on
  29.  the RAM:disk.
  30.  
  31.    2) 'Squeeze' now works.
  32.  
  33.    3) Now able to un'crunch' files in old (4.X) 'crunch' format.
  34.  
  35.    4) Dates are now handled correctly.
  36.  
  37. Known bugs remaining:
  38.  
  39.    None.
  40.  
  41. Items of Note:
  42.  
  43.    1) The Run command will NOT be supported.
  44.  
  45.    2) The current version uses the MSdos '.ARC' file structure. This means
  46.       that file names should follow MSdos conventions. The next version will
  47.       be able to use the full AmigaDos filenames, and will have an MSdos
  48.       compatibility option.
  49.  
  50.    3) Wild Cards are permitted in the filename portion of the template, but
  51.       NOT in the path. The Wild Card scheme used is:
  52.  
  53. /*
  54.  * WCmatch: Function to determine if the first string matches
  55.  *    the template in the second string. If the third parameter
  56.  *    is zero then case does NOT matter.
  57.  *
  58.  *    Returns:
  59.  *       1 if string matches template.
  60.  *       0 if string does NOT match template.
  61.  *       Any other value indicates a template syntax error.
  62.  *
  63.  *    19860308 Raymond S. Brand
  64.  *
  65.  *    Version 0.08
  66.  *
  67.  *    The following describes the syntax of a valid template.
  68.  *       Items in braces ('{' and '}') may be repeated zero or more times.
  69.  * 
  70.  * <template>  := <AGroup>
  71.  * 
  72.  * <AGroup>    := <PGroup>{&<PGroup>}  'AND'
  73.  *
  74.  * <PGroup>    := <LGroup>{|<LGroup>}  'OR'
  75.  *
  76.  * <Group>     := <LGroup>{|<LGroup>}  'or'
  77.  * 
  78.  * <LGroup>    := <SGroup>{<SGroup>}   'Match-String'
  79.  * 
  80.  * <SGroup>    := (<Group>)            'grouping'
  81.  *             := %                    'End-of-Name'
  82.  *             := ^<SGroup>            'NOT'
  83.  *             := <Literal1>
  84.  *             := ?                    'Any-Character'
  85.  *             := #<SGroup><MGroup>    'Zero-or-More Followed-By'
  86.  *             := *<MGroup>            'Zero-or-More-of-Any-Character'
  87.  *             := [<EnumList>]         'Enumeration-List'
  88.  * 
  89.  * <MGroup>    := <LGroup>
  90.  *             :=
  91.  *
  92.  * <EnumList>  := <EnumPart>{,<EnumPart>}
  93.  *
  94.  * <EnumPart>  := <Literal2>
  95.  *             := <Literal2>-<Literal2>   'All-Characters-From To'
  96.  * 
  97.  * <Literal1>  := <any printing character except:
  98.  *                   '#', '%', '^', '&', '*', '(', ')', '|', '\', '[',
  99.  *                   ']' and '?'>
  100.  *             := \<any printing character including the above>
  101.  * 
  102.  * <Literal2>  := <any printing character except:
  103.  *                   '\', '[', ']', '-' and ','>
  104.  *             := \<any printing character including the above>
  105.  *
  106.  *
  107.  *    NOTES:
  108.  *       The 'AND' and the 'OR' functions have an implicit 'End-of-Name'
  109.  *          function before their respective operators.
  110.  *       The 'or' function moves the internal name pointer just past the
  111.  *          first match that it finds.
  112.  *       The second form of <EnumPart> matches the current name character
  113.  *          if the first literal is less than or equal to the current name
  114.  *          character, and the current name character is less than or equal
  115.  *          to the second literal. Or if the first literal is less than the
  116.  *          current name character, or the current name character is less
  117.  *          than the second literal when the first literal is greater than
  118.  *          the second literal. An <EnumPart> will never match the name
  119.  *          terminator. e.g. 'a-f' will match 'a', 'b', 'c', 'd', 'e' and
  120.  *          'f'; Whereas, 'f-a' will match all characters except 'a', 'b',
  121.  *          'c', 'd', 'e' and 'f'.
  122.  *       The '*' operator is equivalent to '#?'.
  123.  */ 
  124.  
  125.    4) This is a beta test version, please keep backups of all important
  126.       files. If you experience a problem or bug in the program, please send
  127.       me a message describing what you were doing and what happened (be
  128.       specific) at:
  129.  
  130.          The Lido Hotel (a Fido BBS)
  131.          (203) 248-7324 (Ct.)
  132.          (where I try to 'check in' everyday)
  133.  
  134.          Amuse (a Fido BBS)
  135.          (212) 269-4879 (NYC)
  136.          (where I will try to login at least once a week)
  137.  
  138.          Maxi-Soft (a Fido BBS)
  139.          (408) 372-1722 (Ca.)
  140.          (where I will try to login at least once a week)
  141.  
  142.    5) Do NOT bother System Enhancement Associates about this program. They
  143.       have little to do with the Amiga version of ARC.
  144.  
  145.    6) Real documentation will become available at the release of the
  146.       production version of AmigArc.
  147.  
  148.    7) Suggestions, comments, criticisms, etc. are welcome and encouraged.
  149.  
  150.    8) This version of AmigArc will cease all functions execpt EXtract
  151.       May 1st, 1986. This is to force you to get a non-test (and hopefully
  152.       less buggy ) version. I will NOT support this version after June 1st,
  153.       1986.
  154.  
  155.    9) For the latest version of AmigArc check the Lido Hotel.
  156.  
  157.   10) To speed compression, ASSIGN ARCTEMP: RAM:
  158.  
  159.   11) The correct file size for AmigArc is 62208 bytes.
  160.  
  161.                          Raymond S. Brand
  162.  
  163.